home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / public / fax / src / relnotes / ch3.cmm < prev    next >
Text File  |  1994-08-01  |  3KB  |  69 lines
  1. .ds FF Flex\s-1FAX\s+1
  2. .nr H1 2
  3. .H 1 "Troubleshooting"
  4. .P
  5. There are several components of this system: client applications
  6. (sendfax, faxstat, faxrm, etc.), the job submission process
  7. (faxd.recv), and the facsimile/modem server (faxd).  If you have
  8. trouble setting up this software, first check out the manual pages.
  9. All client applications support a \-v option to enable various levels of
  10. debugging.  It is possible with one or more \-v options to trace the
  11. protocol between the application and the faxd.recv process on the
  12. server machine.  faxd.recv has a \-d option that enables tracing of the
  13. protocol it receives and its general operation.
  14. .P
  15. faxd has many tracing controls described in the \f2config\fP\|(4F) manual
  16. page.  faxd tracing information is controlled by two configuration
  17. parameters: \f3ServerTracing\fP and \f3SessionTracing\fP.
  18. \f3ServerTracing\fP controls
  19. tracing during the time the server is \fInot\fP engaged in conversation with
  20. another fax machine. 
  21. \f3SessionTracing\fP controls tracing during the time
  22. the server is engaged in conversation with another fax machine.  Server
  23. tracing information is captured via \f2syslog\fP\|(3). 
  24. This means that to
  25. capture the tracing you must setup the appropriate configuration
  26. information for the syslogd process.  In particular, make sure that you
  27. capture daemon.info, daemon.debug, and daemon.err (or substitute for
  28. daemon to reflect local configuration).  Session tracing is stored
  29. in files in the \f2log\fP subdirectory in the spooling tree. 
  30. Consult \f2log\fP\|(4F)
  31. for more information.  Normal installation of this software will enable
  32. sufficient session tracing to debug communication problems.  Unexpected
  33. problems may require you to alter either or both of the \f3ServerTracing\fP
  34. and \f3SessionTracing\fP parameters.
  35. .P
  36. When tracking down a problem, be sure to work your way from the client
  37. application through faxd.recv and into the faxd process.  When
  38. debugging modem-related problems, only enable the tracing that you
  39. really need.  Enabling all tracing can affect the operation of the
  40. server by altering the timing of operations.  The default configuration
  41. files come with \f3SessionTracing\fP set to 11 which is a good setting for
  42. Class 2 modems (i.e. a lot of information is provided, but the load on
  43. the server should not keep it from operating properly).  For Class 1
  44. modems a setting of 0x4f will also cause \s-1HDLC\s+1 frames to be collected.
  45. Beware of tracing timer operations and modem i/o; these trace flags are
  46. only useful if you are trying to debug a problem specifically related
  47. to a timer not going off, or a problem where data appears to be
  48. corrupted.  Also, when capturing a trace for the purpose of submitting
  49. a bug report, the less extraneous information that you include, the
  50. easier it is for people to help understand the problem.  A good way to
  51. capture a transcript of a problem is to use the transcript shell script
  52. in the bin directory of the spooling area.  For example,
  53. .P
  54. .sp .5
  55. .nf
  56. .ft 7
  57. % cd /usr/spool/fax
  58. % bin/transcript 2241 14159657824
  59. .ft 1
  60. .fi
  61. .sp .5
  62. .P
  63. where "2241" here is the process id of the faxd process and
  64. "14159657824" is the canonical phone number associated with the problem
  65. (i.e. the destination if an outgoing call or the local number if an
  66. incoming call).  Note that transcript will only present the trace
  67. associated with the last session, so you need to run it immediately
  68. after the problem occurs (or else extract the session by hand).
  69.